home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / aputdesc.zip / APUTDESC.DOC next >
Text File  |  1992-05-30  |  4KB  |  91 lines
  1. APUTDESC    (c) 1992             Karl Schneider
  2.                                  8505 Woodwick Ct.
  3. For Wildcat! 3.0x+ ONLY!         Tampa, FL 33615
  4.                                  813-884-9661 voice day/eve
  5.                                   "   "   "   bbs midnite-0700 EST
  6.                                               14400 HST
  7.  
  8. ---------------------------------------------------------------------------
  9.                             Introduction
  10.  
  11. APUTDESC is a 'companion' program to my AUTODESC program.  AUTODESC
  12. tests archives (ZIP, ARJ or LZH) at the time of UPLOAD to a WC 3+
  13. system, for the existence of a file inside the archive called DESC.SDI
  14. which simply contains a 60 character or less DESCRIPTION of the
  15. uploaded ZIP etc. file.  If DESC.SDI is found, AUTODESC will auto-
  16. matically insert its contents into the WILDCAT! Database record's
  17. description field for that file, and the person doing the upload
  18. can skip typing in descriptions.
  19.  
  20. If you're familiar with AUTODESC, you probably also know about PUTDESC
  21. which is used to manually add the DESC.SDI file to a particular ZIP,
  22. ARJ or LZH archive, and possibly ALLSDI, which will create DESC.SDI
  23. files in ALL archives indexed in a WC database.
  24.  
  25. APUTDESC can be used in your SCANFILE.BAT (.RUN) in conjunction with
  26. AUTODESC.  It's purpose is to ADD a DESC.SDI file to an uploaded ZIP,
  27. ARJ or LZH file AT THE TIME IT'S UPLOADED...if it does not already
  28. contain one.  The DESC.SDI file will contain whatever text is entered
  29. by the uploader.  If the person doing the upload does NOT enter a
  30. description, the file will not be created or added to the archive.
  31. ------------------------------------------------------------------------
  32.                            Installation
  33.  
  34. You must have the following programs available to DOS, when using
  35. SCANFILE, either in your WC Home Directory, or someplace in your
  36. PATH:
  37.  
  38. APUTDESC.EXE
  39. PKUNZIP.EXE
  40. PKZIP.EXE
  41. ARJ.EXE
  42. LHARC.EXE
  43.  
  44. If you want to support .LZH files, you must have LHARC.EXE.  If you
  45. have a different version named LHA.EXE, you may either re-name it
  46. or COPY it to LHARC.EXE.
  47.  
  48. In your SCANFILE.BAT (.RUN) file, add the following command:
  49.  
  50. aputdesc %1
  51.  
  52. This should immediately FOLLOW 'autodesc %1' if you're using it!
  53. -----------------------------------------------------------------------
  54.  
  55.                           Notes & caveats
  56.  
  57. APUTDESC, like AUTODESC, attempts to minimize run-time by reading the
  58. Wildcat ALLFILES.DAT file from the END, rather than from the BEGINNING.
  59. This normally provides the fastest access, since usually new uploads
  60. are added to the END of the Database.  Note, however, if you DELETE
  61. FILES (from within Wildcat or with WCPRO), the record for the deleted
  62. file does not 'disappear', it is simply flagged as 'deleted'...and
  63. a subsequent upload will be placed into it's location.
  64.  
  65. For this reason, if you DELETE SEVERAL FILES from the WC Database,
  66. it's helpful to run WCREPAIR on the Files database after doing so.
  67. This is not so much a 'repair', as a 're-packing', and, even though
  68. MSI doesn't recommend it unless needed, there is no reason NOT to
  69. do it any time you want!  (I even do it every night in an event).
  70.  
  71. And, please understand that, as with any software, wide
  72. variations in system configurations can sometimes cause unexpected or
  73. unforseeable results.  For this reason, I make no warranties with
  74. respect to this program as to its usability, safety to data, or any
  75. results deriving from its use, and accept no responsibility for any
  76. loss or damages directly or indirectly caused by using it.
  77.  
  78. I've tested APUTDESC as thoroughly as possible, and have found no
  79. problems with it.  It supports file sharing and should run fine on
  80. a network, as my other utilities are reported to do.
  81.  
  82. If this program is useful to you, a modest registration is in order.  If
  83. you contribute $35 or more, you will be entitled to support on ALL
  84. my WC3 utilities.  That's under $1 apiece!.
  85. Any bug reports, comments or suggestion are solicited and welcome!  Thanks.
  86.  
  87. See also:  AUTODESC.ZIP, PUTDESC.ZIP, WCPUTGIF.ZIP, ALLSDI2.ZIP
  88.  
  89. -eof-
  90.  
  91.